home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 051-075 / disk_059 / mcad / mcad.doc < prev    next >
Text File  |  1992-05-06  |  17KB  |  372 lines
  1.    mCAD Version 1.2.2    3/6/87    Tim Mooney
  2.  
  3.    mCAD is an object-oriented drawing program.  It has a small set of
  4. graphics primitives (like "line", "box", and "text") and a small set of
  5. editing functions (like "move", "size", and "rotate").  While drawing and
  6. editing, the user can call on other functions to modify the display -- to
  7. zoom in, slide around, superimpose a grid, etc. 
  8.  
  9.    The one powerful feature of mCAD is that primitives can be grouped and
  10. ungrouped; the editing functions operate on groups of (one or more)
  11. primitives.  In these instructions, "group" and "object" will mean either a
  12. single primitive or a group of primitives.
  13.  
  14.    Most (surely all!) Amiga users know how to use the mouse to draw pictures. 
  15. In mCAD, the mouse does mostly what you're accustomed to from programs like
  16. GraphiCraft.  There are three differences:
  17.  
  18.    1) In mCAD, you are called on to SELECT objects for treatment with one of
  19. the editing tools.  Since mCAD can't know for which of two or more
  20. overlapping objects your SELECT click was intended, it runs through a list of
  21. all the possibilities, highlighting each in turn.  In this context, the MENU
  22. button means "No, not that one", the SELECT button means "Yes, the
  23. highlighted object is the one I want". 
  24.  
  25.    2) While drawing a primitive (exception: text) or editing a group
  26. (exception: coloring), mCAD gives you a chance to abort the whole operation. 
  27. In this context, the MENU button means "Abort", the SELECT button means "The
  28. highlighted object is drawn as I want it, make it permanent."
  29.  
  30.    3) Certain editing functions, "Size" for example, require additional
  31. information and indicate this by drawing a highlighted object.  You are asked
  32. to click on (SELECT button) e. g., one corner of a box. 
  33.  
  34.    So, generally, when the mouse buttons don't have their Intuition meanings,
  35. the SELECT button means "Yes/ok/do it...", and the MENU button means
  36. "No/abort/get me out of this".  This follows the accepted Amiga convention
  37. that "left" breaks new ground while "right" is conservative and safe.  If you
  38. get lost in -- or called away in the middle of -- a sequence of mouse clicks,
  39. a couple of MENU button clicks will get you out of it. 
  40.  
  41. *********************************************************************
  42. THE COMMAND LINE:  to call up the program
  43. *****************
  44.  
  45. mCAD ?         Help
  46. mCAD filename  Create/Edit a drawing named "filename".  You need not type
  47.                the filename if you intend to load the file from within mCAD.
  48.  
  49.  
  50. *********************************************************************
  51. THE MENU:   menu items that don't work or aren't yet implemented are
  52. described by "*"
  53. *********
  54.  
  55. *************
  56. PROJECT
  57.  
  58. New         Erases the current drawing.
  59.  
  60. Open        Opens a drawing which exists on disk for viewing and/or editing.
  61.             MicroSmith's file requester is used to specify the file name.
  62.  
  63. Save        Saves the drawing to disk using the current drawing name.  The
  64.             current drawing name is either the name that occurred on the
  65.             command line, or the name of the file most recently "Open"ed.
  66.             The default drawing name is "mCAD.out".
  67.  
  68. SaveAS      Saves the drawing to disk.  MicroSmith's file requester is used
  69.             to specify the file name.
  70.  
  71. Plot        Saves the (entire) drawing as a plot file in the Hewlett Packard
  72.             Graphics Language.  Instructions are included in the file to
  73.             enable XON/XOFF handshaking with the plotter.  To actually make
  74.             the plot, copy the plot file to SER: The plot file name has the
  75.             same root as the current drawing name, and the extension ".plt"
  76.  
  77. Quit        Quits mCAD.  If you have made any changes to the current drawing,
  78.             you will be asked if you want to save it.
  79.  
  80.  
  81. *************
  82. PART
  83. mCAD expects the current directory to contain a sub-directory called "part".
  84. MicroSmith's file requester will let you change directories, however.
  85.  
  86. Open        Includes an mCAD drawing, which was previously saved to disk, in
  87.             the current drawing.  You will use MicroSmith's file requester to
  88.             specify the part name.
  89.  
  90. Save        Saves a group to disk using the current part name.  Select the
  91.             group you want to save with the mouse as described above.
  92.  
  93. SaveAs      Saves a group to disk by name.  Select the group with the mouse.
  94.  
  95. Group       Groups objects together for treatment with an editing tool or to
  96.             be saved as a "part".  Draw a box completely enclosing the
  97.             objects you want treated as a group.  An object can only be in
  98.             one group at a time.  If an enclosed object is already part of a
  99.             group, it will be extracted from that group.  If an entire group
  100.             is enclosed, that group will merge into the new group. 
  101.  
  102. UnGroup     Select a group by clicking on any of its members.  On the
  103.             confirming SELECT click, the group will be dismembered.
  104.  
  105.  
  106. *************
  107. OPTIONS
  108.  
  109. Replot      Redraws the screen.  The options "Axes" and "Grid" do not cause a
  110.             replot automatically because redrawing can take a long time, and
  111.             because you may want to make another display selection before
  112.             redrawing. 
  113.  
  114. Zoom        1)  Draw a box around the region you want to see up close.  mCAD
  115.             will zoom in to the biggest region consistent with both the box
  116.             you drew and the aspect ratio of the drawing.  Note: in this
  117.             version the aspect ratio cannot be changed by any command.
  118.             2)  Click twice in the same spot.  mCAD will zoom out by a
  119.             factor of two.
  120.  
  121. Slide       Draw a line.  On your second SELECT click mCAD redraws the
  122.             picture as if your first click had grabbed a hold of the page. 
  123.             (mCAD is too slow to move the whole picture along with the mouse
  124.             and memory is too precious to spend on a scrollable screen.)
  125.  
  126. FullPlot    Zooms out to show the whole drawing.
  127.  
  128. Axes        This is a toggle switch that puts axes on the display.
  129.             See Replot.
  130.  
  131. Grid        This is a toggle switch that puts a grid over the display.
  132.             See Replot.
  133.  
  134. X-Hair      This is a toggle switch.  The mouse pointer is replaced by a
  135.             crosshair.  (Notice what happens when you press the MENU button
  136.             and move the mouse.)            
  137.  
  138. GridSnap    This is a toggle switch.  Primitives (exceptions: text, circle,
  139.             arc) drawn with GridSnap enabled will snap to the grid on your
  140.             *final* SELECT click.  When enabled, menu item reads "GRIDSNAP". 
  141.  
  142. DataSnap    This is a toggle switch.  Primitives (exceptions: text, circle,
  143.             arc) drawn with DataSnap enabled will snap to previously drawn
  144.             objects (if they are close enough) on your final SELECT click.
  145.             Points are more "attractive" than lines connecting those points.
  146.             When enabled, menu item reads "DATASNAP"
  147.  
  148. nTics*2     Increases the density of tics / grid lines.  A maximum is
  149.             enforced.  This item causes a replot. 
  150.  
  151. nTics/2     Decreases the density of tics / grid lines.  A minimum is
  152.             enforced.  This item causes a replot. 
  153.  
  154. ShowXY      Calls up a numeric readout in the current plot color of the
  155.             pointer position.  The readout is in USER coordinates (the
  156.             numbers which are drawn when you select "Axes" are in USER
  157.             coordinates.) The readout consists of the absolute X
  158.             (horizontal) and Y coordinates and the distances from the
  159.             location of the most recent SELECT click. 
  160.  
  161.  
  162. *************
  163. DRAW
  164.  
  165. Line        Draw a sequence of (one or more) connected lines.  Click twice
  166.             on your final point. 
  167.  
  168. Box         Draw a box by clicking on two corners.
  169.  
  170. Circle      Draw a circle by clicking on the center position, moving the
  171.             mouse to change the size, and clicking again when the size is
  172.             right. 
  173.  
  174. Arc         Draw an arc with three mouse clicks: the first click sets the
  175.             center;  the second click sets the radius and starting angle;
  176.             the third click sets the ending angle. 
  177.  
  178. Measure     *
  179.  
  180. Clone       Select a group by clicking on any of its members.  A duplicate
  181.             will follow the mouse pointer until you press either the MENU
  182.             button ("abort") or the SELECT button. 
  183.  
  184. TextSize    Draw a box indicating the size/aspect of the letters you plan
  185.             to type onto the screen.
  186.  
  187. Cursor      SELECT the location of the text cursor.
  188.  
  189.  
  190. *************
  191. EDIT
  192. In every case, you first select a group for treatment.
  193.  
  194. Erase       SELECT a highlighted group to erase it.
  195.  
  196. Size        SELECT a highlighted group.  mCAD draws the smallest enclosing
  197.             rectangle (possibly a line).  You SELECT a corner of the
  198.             rectangle to begin sizing.  The group is scaled as the mouse
  199.             moves.  Press the SELECT button, when you like what you see, or
  200.             the MENU button to abort. 
  201.  
  202. Move        Select a group by clicking on any of its members.  The group
  203.             will follow the mouse pointer until you press either the MENU
  204.             button ("abort") or the SELECT button. 
  205.  
  206. Rotate      The selected object is rotated about its "center".  Vary the
  207.             angle by moving the mouse and click SELECT to finish or MENU to
  208.             abort. 
  209.  
  210. Rot +90     Select a plot.  The selected plot will be rotated counter-
  211.             clockwise by 90 degrees.
  212.  
  213. Rot -90     Select a plot.  The selected plot will be rotated clockwise by
  214.             90 degrees.
  215.  
  216. Point       Select a group.  When the group you want to modify is
  217.             highlighted, click on the point you would like to move.  The
  218.             point and lines connecting it to adjacent points will follow
  219.             the mouse.  Click SELECT to finish or MENU to abort.
  220.  
  221. Color       Select a group.  The selected group immediately turns to the
  222.             current plot color.  (No chance for abort here.)
  223.  
  224.  
  225. *************
  226. COLORS
  227.  
  228. color boxes    Your menu selection becomes the current plot color.
  229.                Initially, the current color is #4 (first box in second row
  230.                of the palette). 
  231.  
  232. Modify Colors  Call up Microsmith's Palette tool (a very nice tool written
  233.                by Charlie Heath).
  234.  
  235. Save Colors    Save current colors to the file "mCAD.rgb" which is read by
  236.                mCAD on startup. 
  237.  
  238.  
  239. ************************************************************************
  240.  
  241. NEW FEATURES
  242.  
  243. Version 1.2
  244.  
  245.    File input and output from within mCAD has been added.  Thanks to Charlie
  246. Heath and MicroSmith's for the file requester and, while I'm at it, for their
  247. palette tool.  This is the hard stuff, folks.  If I had had to write these
  248. tools myself, you can be sure that they wouldn't be such a pleasure to use,
  249. and that I would be asking for more of a donation than $20.
  250.  
  251.    Point editing has been added.  This feature allows you to move a single
  252. point of a group without affecting other points.
  253.  
  254.    A shortcut for rotating by 90 degrees has been added.  (The original
  255. motive for this was to rotate entire drawings before plotting.)
  256.  
  257.    Several bugs that once caused mCAD to crash have been fixed.  mCAD now
  258. realizes that mouse clicks are being queued up "behind its back" and that
  259. disabling them doesn't erase queued messages.
  260.  
  261.    Groups work right.  In previous versions, the result of grouping objects
  262. that were already in different groups depended on the order in which those
  263. groups had been formed. 
  264.  
  265.    mCAD can now read a file and add the objects in that file to its linked
  266. list of objects.  In other words, the "Parts" menu is fully implemented.  It
  267. may be useful to know that there is no difference, to mCAD, between a "part"
  268. file and a "cad" file.  You can treat a whole drawing as a part and
  269. vice-versa.  You can also use the outputs of the programs "mp" and "tdp" as
  270. parts or as drawings. 
  271.  
  272.    Tab, backspace, and carriage return now do what they say they do.
  273. Backspace does not erase, however.  Also, see "BUGS/WARNINGS...".
  274. ************************************************************************
  275.  
  276. HINTS, SUGGESTIONS ...
  277.  
  278.    mCAD's input file format is very simple.  You can make an mCAD file by
  279. hand or with a simple program in "c", Basic, etc.  In fact, this file can
  280. be used as input to mCAD.  The only lines mCAD will pay attention to are
  281. the following: --------------------------
  282.  
  283. 100 100     This is a box..
  284. 100 200     Note: if you use this file as input to mCAD, DO NOT SAVE!
  285. 200 200     mCAD will cheerfully erase this file, leaving in its place
  286. 200 100     a file consisting only of the numbers to the left.
  287. 100 100
  288. *>          The object above this mark is in a group with the object below it.
  289. *C 4        This object is in color 4
  290.  
  291. 125 150     This is a line..
  292. 175 150
  293. *C 5  
  294.  
  295.       --------------------------
  296.  
  297.    I prefer a "fast" mouse for most programs, but would like a slower one
  298. for doing fine work with mCAD.  I haven't found a way to change the mouse
  299. speed while in the program (any ideas, Amiga gurus?), but an acceptable
  300. substitute is using the Amiga-arrow keys.  You may have forgotten about this
  301. keyboard alternative since it is so rarely useful.  Also, don't forget about
  302. Amiga-alt for mouse buttons.  (Sometimes, I inadvertently move the mouse
  303. while clicking a mouse button.)
  304.  
  305.    Grouping objects:
  306.    Since the only way to indicate which objects you want in your group is to
  307. draw an enclosing rectangle, you may be having trouble getting just the
  308. objects you want.  You don't have to enclose all the desired objects at once,
  309. however. Two or more rectangles can be used.  If you group objects which
  310. already are parts of separate groups, the groups will be merged. 
  311.  
  312.    When X-Hair is not selected, the Intuition pointer is supplemented with a
  313. dot at the current location of the graphics cursor.  (You may know that the
  314. Intuition pointer is implemented in low resolution and therefore cannot, with
  315. precision, select a point on a high resolution screen.  The dot is a remedy
  316. for this.)  To make effective use of the dot -- indeed, too SEE it -- your
  317. pointer should have its "hot spot" on one of the "transparent" pixels.  In
  318. Preferences, use the "Set Point" option while you "Edit Pointer". 
  319.  
  320.    To keep a constant text size in your drawing through many edits, or from
  321. drawing to drawing, you might consider making a box of the desired text
  322. size and saving it as a part called "textsize".  When you want to set your
  323. text size, then: open the "textsize" part;  select "TextSize" from the
  324. "Draw" menu; and draw a box exactly like the "textsize" box.
  325. ************************************************************************
  326.  
  327. BUGS, WARNINGS, ADDITIONAL NOTES ...
  328.  
  329.    You MUST select a text size and cursor location before typing text into
  330. your drawing.  The defaults aren't done right in this version.  This means
  331. that, if you don't specify the size and location before drawing your first
  332. letter, text will be put any old where in some arbitrary size -- which, in
  333. turn, means that you can expect a short, one-sided chat with the Guru the
  334. next time you select "FullPlot". 
  335.  
  336.    Letters, in this version, are REALLY primitives; all points are connected
  337. together as though drawn with a single "Line" command.  This means characters
  338. like [ ! = ? : ; " Q ] don't look so good.  (Ok, they look awful!).  Text is
  339. likely to improve in some future version. 
  340.  
  341.    Occasionally, with both the X-Hair and the dot, trash may be left on the
  342. screen after editing a group.  Use "Replot" for now.  (I don't consistently
  343. "pick up" the dot/crosshair before drawing over it.) 
  344.  
  345.    mCAD doesn't do ANY memory checking.  It will crash the system or exit
  346. without returning allocated memory if it finds that there isn't enough memory
  347. to do whatever it wants to do.  In a multi-tasking system with a ram disk,
  348. this is bound to happen to you sooner or later.  This IS going to be fixed!
  349. Until it is fixed, I suggest you save your drawing often and keep an eye on
  350. the amount of ram available.
  351.  
  352.    Tim Mooney
  353.    120 Purefoy Rd.
  354.    Chapel Hill, NC 27514
  355.  
  356.    If you have a modem, you can leave me mail at the following bulletin
  357.    board which I monitor regularly.
  358.  
  359.       "Deep Thought"   (919) 471-6436
  360.  
  361. ------------------------------------------------------------------------
  362.  
  363.    Registered users:
  364.  
  365.    I plan to move sometime in the fall of '87.  When I do, I'll leave a
  366. forwarding address on the bulletin board mentioned above and with:
  367.  
  368.    Department of Physics and Astronomy
  369.    Phillips Hall
  370.    University of North Carolina
  371.    Chapel Hill, NC  27514
  372.